home *** CD-ROM | disk | FTP | other *** search
/ 3D Images / 3D Images.iso / programs / amiga / mpegplay2 / readme.amiga < prev    next >
Text File  |  1995-01-12  |  8KB  |  224 lines
  1.                   MPEG Video Software Decoder
  2.                   (Version 2.0; Jan 27, 1993)
  3.  
  4.         Lawrence A. Rowe, Ketan Patel, and Brian Smith
  5.  Computer Science Division-EECS, Univ. of Calif. at Berkeley
  6.  
  7.      Amiga version 2.01 (Feb 12 1993) by Michael Balzer
  8.    Student of Computer Science, Univ. of Dortmund, Germany
  9.  
  10.  
  11. Intro
  12. =====
  13.  
  14. This is the third release of the first public domain MPEG viewer
  15. for the Commodore Amiga.  Please also read the file "README" for
  16. some general information about this software.
  17.  
  18. This player needs at least a 68020 CPU (and 881 FPU).  Compile
  19. yourself if you need a 68000 version, or you might give Kamran
  20. Karimi's Run68017 68020 emulation a try but I don't guarantee it
  21. will work.
  22.  
  23. AmigaOS 2.04 or higher required.
  24.  
  25. This player needs Markus Wild's ixemul.library. As this lib still
  26. doesn't seem to exist on everyone's machines, I have included it
  27. with this distribution. For the complete GCC distribution contact
  28. your next FTP server.
  29.  
  30. And... NO, THIS PLAYER DOESN'T NEED X-WINDOWS!
  31.  
  32.  
  33. Changes against V1.22 (second release):
  34.  
  35.  * Release 1.23 (not released due to 2.01):
  36.  *    - Dither mono & threshold now work (fast!)
  37.  *    - New option: -saveiff framename_%d.iff (guess for what ;-)
  38.  *      Saving currently forces screen mode. No support for 24 bit yet
  39.  *    - Added new option: -amiga screen:mode/depth/width/height,
  40.  *      reworked option dependancies
  41.  *
  42.  * Release 2.01 (Feb 12 1993):
  43.  *    - Based upon the new 2.0 release of the mpeg player for UNIX
  44.  *    - No need to enhance color allocation, as the new player
  45.  *      allows to set the range values (ncolors = l_rng*cr_rng*cb_rng)
  46.  *    - 24 Bit IFF save mode implemented
  47.  
  48.  
  49. Amiga Specials
  50. ==============
  51.  
  52. Get the usage info by calling "mpeg_play -?". There are two
  53. additional options in the amiga version, each needing one
  54. parameter:
  55.  
  56. 1a) -amiga window
  57.  
  58. This lets the player display the animation in a window on your
  59. workbench (better: default public screen). If this option is not
  60. specified, the player will open an own screen.
  61.  
  62. 1b) -amiga screen[:id[/depth[/width[/height]]]]
  63.  
  64. This tells the player to open the specified screen without
  65. opening the ScreenMode request.  All parameters are optional, a
  66. plain "-amiga screen" will open a screen of your default display
  67. mode (lores) with width 320, height 200 and depth 8 (256 colors).
  68.  
  69. You can get the ID for a mode by a) looking into
  70. graphics/modeid.h or b) leaving the screen option away and
  71. choosing the preferred display mode from the screen mode
  72. requester, the player will then print the according option text
  73. before playing the anim.
  74.  
  75. Example usage: "-amiga screen:0x91000/7" will open a DoubleNTSC
  76. lores screen of size 320 x 200 with 128 colors.
  77.  
  78. 2) -saveiff framename_%04d.iff
  79.  
  80. This one is usefull for converting an MPEG anim to an IFF anim.
  81. The player will save each frame to disk, using the given name
  82. template. The format string should contain something like "%04d",
  83. which will be replaced by the frame number.
  84.  
  85. The leading "0" means the number will have leading '0's if it's
  86. shorter than the second value ("4" = 4 digits), you should always
  87. use this because otherwise it's very difficult to sort the frames
  88. afterwards (e.g. frame10 will come before frame2).
  89.  
  90. When saving, loop mode is automatically disabled and the player
  91. will use a custom screen for output (unless you are saving 24 bit
  92. true color ILBMs by specifying "-dither color").
  93.  
  94. You should use exactly the resolution of the anim (player prints
  95. it at the beginning) for the screen if saving, in order to reduce
  96. the size of the frames (the player saves the complete screen).
  97.  
  98. I have included John Bickers' "mkanim" tool and a script file
  99. that does the conversion of the single frames into an ANIM5
  100. animation for you. Have a look at it, it's quite simple and
  101. customizable.
  102.  
  103.  
  104. Example usages
  105. ==============
  106.  
  107. 1> mpeg_play movies/micky.mpg
  108.  
  109.     This will ask you for the screenmode and display the anim on
  110.     a custom screen.
  111.  
  112. 2> mpeg_play -amiga screen movies/micky.mpg
  113.  
  114.     This will open a 320x200x8 lores screen and display the anim.
  115.  
  116. 3> mpeg_play -amiga window movies/micky.mpg
  117.  
  118.     This will display the anim in a window on the workbench.
  119.  
  120. 4> mpeg_play -amiga screen:0/8/160/120 -saveiff ram:micky%02d.iff
  121.    movies/micky.mpg
  122.  
  123.     This will display micky.mpg on a 160x120x8 lores screen and
  124.     save the frames as ram:micky00.iff, ram:micky01.iff, ...
  125.     You might then cd to ram: and type "makeanim micky" to generate
  126.     an IFF anim from the frames.
  127.     
  128.     Be carefull when saving single frames - there fit a lot of
  129.     pictures in those mpeg anims! For example, I have converted
  130.     the "iicm.mpg" anim (a very nice one!), it contains 800
  131.     frames and the IFF anim file's size is 6.3 MB... (but it's
  132.     a lot of fun to view it in full speed :-)
  133.  
  134. 5> mpeg_play -dither color -saveiff ram:micky%05d.i24 movies/micky.mpg
  135.  
  136.     Will display nothing but save each frame in IFF 24 bit format
  137.     to ram:micky00000.i24, ram:micky00001.i24 and so on.
  138.  
  139.  
  140. When displaying on less than 128 color screens, you should
  141. experiment with the range options '-l_range', '-cr_range' and
  142. '-cb_range'. Normal values for them are 8, 4 and 4 respectively.
  143.  
  144. Multiplying the three values gives you the amount of colors
  145. allocated, so on 32 colors you should try e.g. 8, 2 and 2 or 4, 2
  146. and 4.
  147.  
  148. There are several dithering methods implemented in this player,
  149. you should try them all to get a feeling of what they look like.
  150.  
  151. There's still no HAM support, but I'll think about it.
  152.  
  153.  
  154. Amiga Bugs
  155. ==========
  156.  
  157. There's a known problem: When breaking the player while displaying
  158. on a custom screen, the player sometimes crashes. I don't know
  159. what this problem might be, I guess it's in the GCC's library.
  160. Any hints are very welcome.
  161.  
  162.  
  163. Domino Specials
  164. ===============
  165.  
  166. Attention, DOMINO owners!  The current Domino software (Intuition
  167. emulator) has an ugly bug (took me one day to find out), all
  168. graphics calls are limited to a maximum of 5 planes (32 colors)
  169. when running on the Domino!
  170.  
  171. This affects displaying and saving of both palette modes with
  172. more than 32 colors _and_ true color mode, as I use standard
  173. graphics calls for 24 bit as well (3 * 8 bit).
  174.  
  175. Fortunately you don't have to disable the Domino software
  176. completely, switching to a normal Amiga display mode before
  177. running the mpeg player is sufficient.
  178.  
  179. Why I don't use the Domino's VGA and HiColor modes?  I really
  180. would like to, but how?  I'm waiting for XPert finally releasing
  181. their domino.library...
  182.  
  183.  
  184. Speed
  185. =====
  186.  
  187. Don't expect this player to be the Speedy Gonzales of anim
  188. players.  On an Amiga 4000, you get a maximum of about 11 frames
  189. per second (dithering threshold on 2 color NTSC lores screen)
  190. (same on A2000/2630/32MHz:  5 fps), normal rating will be around
  191. 4 to 5 frames per second on an A4000.
  192.  
  193. Nevertheless, this release of the player is on my A4000 nearly as
  194. fast as on a SUN Sparcstation IPC.  I think, many time is spent
  195. converting the data to plane format.  I would love to see future
  196. Amigas offering chunky modes...
  197.  
  198.  
  199. Source
  200. ======
  201.  
  202. There are two archives, one containing the binaries (and other
  203. usefull stuff) and the other one containing the sources (split up
  204. into original UNIX part plus special Amiga changes & extensions).
  205.  
  206. I included the necessary X11 header files (don't think, many
  207. Amiga programmers have them around).  The Makefile and code are
  208. for Markus Wild's port of the famous GNU GCC C compiler (thanks
  209. again, Markus!).  Don't forget to build an amiga.lib version 39.x
  210. for your GCC before trying to compile the code.
  211.  
  212.  
  213. Famous last words
  214. =================
  215.  
  216. Send me email if you have questions, comments or suggestions!
  217.  
  218. UseNet: balzer@heike.informatik.uni-dortmund.de
  219. or at home: bilbo@bagsend.aworld.de
  220. Z-Net:  m.balzer@aworld.zer
  221.  
  222. Have Fun!
  223. Michael
  224.